SAGE II SYSTEM RELEASE NOTES 



September 1982 

The System Release Notes present information which is subject to 
change or specific to a shipment. The directories of the 
distribution diskettes are presented here along with a growing set 
of information on Terminal configuration files. Also contained in 
the System Release Notes is a list of problems and restrictions 
which are currently outstanding in the software. 

DISKETTE FILES: 



The files for 80 track (96 TPI) systems are contained on two 
diskettes called SYSTEM: and UTILITY:. The diskette SYSTEM: is 
bootable on the SAGE II computer. It contains all the critical 
files for running the UCSD p-System. The diskette UTILITY: contains 
p-System utility files as well as other SAGE provided software. 

For 40 track (48 TPI) systems, the bootable diskette is also called 
SYSTEM:. The less critical system files are contained on the 
diskette called UTILl:. The remaining utilities and SAGE provided 
software are contained on the diskette UTIL2 : . 



Directories for 80 track distribution. 



SYSTEM: 



SYSTEM. PASCAL 


119 


13 


-Jun- 


82 


10 


512 


Dataf ile 


SYSTEM. MISCINFO 


1 


1 


-Sep- 


82 


129 


226 


Dataf ile 


USERLIB .TEXT 


4 


13 


-Sep- 


82 


130 


512 


Textf ile 


SYSTEM. LIBRARY 


7 


13 


-Sep- 


82 


134 


512 


Dataf ile 


SYSTEM. SYNTAX 


14 


18 


-May- 


82 


141 


512 


Textf ile 


SYSTEM. FILER 


38 


27 


-May- 


82 


155 


512 


Codefile 


SYSTEM. EDITOR 


47 


7 


-Jun- 


82 


193 


512 


Codef ile 


SYSTEM. COMPILER 


108 


7 


-Apr- 


82 


240 


512 


Codefile 


SETUP. CODE 


36 


14 


-Apr- 


82 


348 


512 


Codefile 


SAGEUTIL.CODE 


46 


8« 


-Sep- 


82 


384 


512 


Codefile 


LIBRARY. CODE 


13 


1 


-Apr- 


82 


430 


512 


Codefile 


SAGEDATE . CODE 


5 


30 


-Aug- 


82 


443 


512 


Codefile 


ENDBOOT 


1 


13 


-Sep- 


82 


448 


512 


Dataf ile 


SYSTEM. BIOS 


20 


13 


-Sep- 


82 


449 


512 


Codefile 


SYSTEM. INTERP 


20 


13 


-Sep- 


82 


469 


512 


Codefile 


SAGETOOLS.CODE 


51 


13 


-Sep- 


82 


489 


512 


Codefile 


YALOE.CODE 


12 


22 


-Apr- 


82 


540 


512 


Codefile 


SAMPLEGOTO • TEXT 


6 


17 


-Jul- 


82 


552 


512 


Textf ile 


SCREENOPS.CODE 


8 


26 


-Apr- 


82 


558 


512 


Codefile 


SCREENTEST . CODE 


13 


27 


-May- 


82 


566 


512 


Codefile 


COPYDUPDIR.CODE 


3 


7 


-Apr- 


82 


579 


512 


Codefile 
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SYSTEM: . •continued. ( or UTILl: on 40 track diskettes) 



SYSTEM • ASSMBLER 


56 


18 


-May- 


-82 


68000. OPCODES 


4 


18 


-Jan- 


-82 


68000. ERRORS 


9 


18 


-Jan- 


-82 


SYSTEM. LINKER 


27 


1 


-Apr- 


-82 


DECODE. CODE 


28 


1 


-Apr- 


-82 


PATCH. CODE 


39 


18 


-May- 


-82 


XREF .CODE 


28 


1 


-Apr- 


-82 


COMPRESS. CODE 


10 


24 


-May- 


-82 


REALCONV • CODE 


4 


25 


-Mar- 


-82 


MARKDUPDIR.CODE 


4 


7 


-Apr- 


-82 


BOOTER.CODE 


3 


18 


-May- 


-82 


INTERP . 0 .CODE 


17 


13 


-Sep- 


-82 


INTERP . 2 . CODE 


20 


13 


-Sep- 


-82 


INTERP. 4. CODE 


22 


13 


-Sep- 


-82 


REALOPS . 2 .CODE 


10 


1 


-Apr- 


-82 


REALOPS . 4 . CODE 


12 


1 


-Apr- 


-82 


ANSI. CODE 


14 


7 


-Jun- 


-82 


ANSIGOTOXY.CODE 


3 


1 


-Apr- 


-82 


ANSI.MISCINFO 


1 


1 


-Sep- 


-82 


VT52 .MISCINFO 


1 


31 


-Aug- 


-82 


VT5 2. GOTO. CODE 


3 


31 


-Aug- 


-82 


TV925. GOTO. CODE 


3 


16 


-Aug- 


-82 


TV925. MISCINFO 


1 


1 


-Sep- 


-82 


H19. MISCINFO 


1 


1 


-Sep- 


-82 


IQ120. MISCINFO 


1 


7 


-Sep- 


-82 


TV912. MISCINFO 


1 


7 


-Sep- 


-82 


COMMANDIO.CODE 


3 


26 


-Apr- 


-82 


DIR. INFO. CODE 


18 


1 


-Apr- 


-82 


DISKCHANGE • CODE 


8 


18 


-May- 


-82 


DISKSIZE.CODE 


3 


18- 


-May- 


-82 


ERRORHANDL . CODE 


3 


27' 


-May- 


-82 


FILE. INFO. CODE 


7 


1- 


-Apr- 


-82 


FINDPARAMS • CODE 


9 


7< 


-Apr- 


-82 


RECOVER. G. CODE 


8 


7- 


-Apr- 


-82 


SYS. INFO. CODE 


5 


1- 


-Apr- 


-82 


WILD. CODE 


6 


1 


-Apr- 


-82 


KERNEL. CODE 


30 


26 


-Apr- 


-82 


S AGE. PBOOT. CODE 


4 


17 


-Aug- 


-82 


SAGE. PBOOT. TEXT 


38 


17 


-Aug- 


-82 


< UNUSED > 


234 








60/60 files<list 


ed/in 


.-a 


ir> , 


10 



582 


512 


Codef ile 


638 


120 


Dataf ile 


642 


272 


Dataf ile 


651 


512 


Codef ile 


678 


512 


Codef ile 


706 


512 


Codef ile 


745 


512 


Codef ile 


773 


512 


Codef ile 


783 


512 


Codef ile 


787 


512 


Codef ile 


791 


512 


Codef ile 


794 


512 


Codef ile 


811 


512 


Codef ile 


831 


512 


Codef ile 


853 


512 


Codef ile 


863 


512 


Codef ile 


87 5 


512 


Codef ile 


889 


512 


Codef ile 


892 


226 


Dataf ile 


893 


226 


Dataf ile 


894 


512 


Codef ile 


897 


512 


Codef ile 


900 


226 


Dataf ile 


901 


226 


Dataf ile 


902 


226 


Dataf ile 


903 


226 


Dataf ile 


904 


512 


Codef ile 


907 


512 


Codef ile 


925 


512 


Codef ile 


933 


512 


Codef ile 


936 


512 


Codef ile 


939 


512 


Codef ile 


946 


512 


Codef ile 


955 


512 


Codef ile 


963 


512 


Codef ile 


968 


512 


Codef ile 


974 


512 


Codef ile 


1004 


512 


Codef ile 


1008 


512 


Textf ile 


1046 







blocks used, 234 unused, 

234 in largest 
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UTILITY: (or UTIL2: on 40 track 



IB • EX .LODE 


z 


1 J 


-Sep- 


•8z 


IB . LNK • CODE 


9 


1 J 


-Sep- 


-82 


IB • UNIT • CODE 


o 
O 


I j 


-Sep- 


*8z 


IB. UNIT. TEXT 


18 


13 


-Sep- 


■82 


IB . EX . TEXT 


8 


13 


-Sep- 


•82 


IB.DEF .TEXT 


16 


13 


-Sep- 


-82 


RECEIVE .CODE 


3 


16 


-Jul- 


"82 


REMINTEST . CODE 


z 


16 


-Jul- 


o **> 

-oz 


REMOUTTEST • CODE 


z 


16 


-Jul- 


O 1 

-oz 


REMTALK . CODE 


6 


1 8 


-May- 


-82 


SEND . CODE 


3 


16 


-Jul- 


-82 


TEXTIN.CODE 


6 


16 


-Jul- 


o o 
-oz 


RECEIVE .TEXT 


8 


16 


-Jul- 


-82 


REMINTEST .TEXT 


4 


16 


-Jul- 


-oz 


REMOUTTEST . TEXT 


4 


16 


-Jul- 


o o 

-oz 


SEND . TEXT 


6 


16 


-Jul- 


-82 


TEXTIN . TEXT 


14 


16 


-Jul- 


-82 


FORTRAN z .CODE 


87 


14 


-Jun- 


o *■> 
-oz 


F0R1RAN4 .CODE 


o7 


14 


-Jun- 


o o 
-oz 


r ORlLIbz . CODL 


Zl 


ID 


-Jun- 


-oz 


F0RTLIB4 .CODE 


21 


16 


- Jun- 


-82 


T2 T T T2 DO C f~\T\ TT 

Ob IB • KZ . CUDb 


38 


27 


— Jan- 


-oZ 


BLIB . R4 .CODE 


38 


27 


-Jan- 


-82 


BASIC. R4. CODE 


78 


28 


-Jan- 


-82 


BASIC. R2. CODE 


77 


27 


-Jan- 


-82 


REMTALK. TEXT 


18 


18 


-May- 


-82 


IB. BUS. TEXT 


40 


13 


-Sep- 


-82 


< UNUSED > 


641 








28/28 files<list 


ed/in-d 


ir> , 


639 



diskettes) 




15 


512 


Codef ile 


17 


512 


Codef lie 


26 


512 


Codef ile 


34 


512 


Textf lie 


52 


512 


Textf ile 


60 


512 


Textf ile 


76 


512 


Codef ile 


79 


512 


Coder He 


81 


512 


Coder lie 


83 


512 


Coder ile 


89 


512 


Coder ile 


92 


512 


Coaer lie 


98 


512 


Textf ile 


106 


512 


Textf ile 


110 


512 


Textf ile 


114 


512 


Textf ile 


120 


512 


Textr ile 


134 


512 


Coder He 


221 


512 


Codef ile 


308 


512 


Coder He 


329 


512 


Codef ile 


350 


512 


Codef lie 


388 


512 


Codef ile 


426 


512 


Loaer ne 


504 


512 


Codef ile 


581 


512 


Textfile 


599 


512 


Textf ile 


639 






blocks 


used 


, 641 unused, 



641 in largest 
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TERMINAL CONFIGURATION FILES: 



The following preconf igured files may be used to configure the 
p-System for the specified terminals. The key assignments for 
these terminals are also presented in tables. 



Terminal : 

TeleVideo 925/950 
TeleVideo 912C/920C 
DEC VT52 

ANSI Standard Term 
(DEC VT100 series) 

Heath H19 
SOROC IQ120 



change file to 
SYSTEM. MI SC INFO 

TV925.MISCINFO 

TV912.MISCINFO 

VT52 .MISCINFO 

ANSI.MISCINFO 



install GOTOXY in 
SYSTEM. PASCAL 

TV925. GOTO. CODE 

TV9 2 5. GOTO. CODE 

VT5 2. GOTO. CODE 

ANSI GOTOXY. CODE 



(note also that ANSI. CODE must be 
installed in SYSTEM. PASCAL to replace 
the existing SCREENOPS routines) 



Hi 9 .MISCINFO 
IQ120. MISCINFO 



VT5 2. GOTO. CODE 
TV925. GOTO. CODE 



KEYBOARD ASSIGNMENTS: 



DELETE KEY 
INSERT KEY 



Terminals: 



EDITOR ACCEPT KEY 
EDITOR ESCAPE KEY 
EDITOR EXCHANGE - 
EDITOR EXCHANGE - 
KEY FOR BREAK 
KEY FOR FLUSH 
KEY FOR STOP 
KEY TO ALPHA LOCK 
KEY TO DELETE CHARACTER 
KEY TO DELETE LINE 
KEY TO END FILE 
KEY TO MOVE CURSOR DOWN 
KEY TO MOVE CURSOR LEFT 
KEY TO MOVE CURSOR RIGHT 
KEY TO MOVE CURSOR UP 



TV912C,TV920C 
TV925,TV950: 



Ctrl C 
ESC ESC 
CHAR DELETE 
CHAR INSERT 
Ctrl @ 
Ctrl F 
Ctrl S 
Ctrl R 
BACKSPACE 
DEL 
Ctrl C 
down arrow 
left arrow 
right arrow 
up arrow 



ANSI 

Standard : 

(VT 100 series) 

Ctrl C 
ESC ESC 
Ctrl D 
Ctrl E 

NUL (see note 1) 

Ctrl F 

Ctrl S 

Ctrl R 

BACKSPACE 

DELETE 

Ctrl C 

down arrow 

left arrow 

right arrow 

up arrow 



Note 1 : Determine which key will generate the NUL ASCII value. 

On the VT102 this is Ctrl space. On some terminals this 
is Ctrl §. This may be changed with SETUP. 
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Terminals : 



VT52: 



Heath H19 
(Note 2) 



E1DJ.XUK t\\^\sEitr 1 ]\CiI 




C v. t JL C 


Ltri c 


XjUIIUK UioV^Alrji REiX 




uor pop 


pop por 


hUllUK bALHANbb — DLLblfcj 


KLx 


Ctrl D 


Ctrl D 




J\£iX 




Ctrl b 


i\rjx r UK r>KCiAJ\ 




ttii space 


LtLl 19 


a. Eil r UK r LUqH 




Ltri r 


Cur X r 


KEY FOR STOP 

JL\ U X X V-/ JA k»J X \s X 




Ctrl S 


Ctrl q 


KEY TO ALPHA LOCK 




Ctrl R 


Ctrl R 


KEY TO DELETE CHARACTER 




BACKSPACE 


BACKSPACE 


KEY TO DELETE LINE 




DELETE 


DELETE 


KEY TO END FILE 




Ctrl C 


Ctrl C 


KEY TO MOVE CURSOR DOWN 




down arrow 


down arrow 


KEY TO MOVE CURSOR LEFT 




left arrow 


left arrow 


KEY TO MOVE CURSOR RIGHT 




right arrow 


right arrow 


KEY TO MOVE CURSOR UP 




up arrow 


up arrow 



Note 2: Consider using the Keypad Shifted option so that the 
shift key is not necessary when using the arrow keys. 



Terminals: 




IQ120: 


EDITOR ACCEPT KEY 




Ctrl C 


EDITOR ESCAPE KEY 




ESC 


EDITOR EXCHANGE - DELETE 


KEY 


Ctrl D 


EDITOR EXCHANGE - INSERT 


KEY 


Ctrl E 


KEY FOR BREAK 




Ctrl underline 


KEY FOR FLUSH 




Ctrl F 


KEY FOR STOP 




Ctrl S 


KEY TO ALPHA LOCK 




Ctrl R 


KEY TO DELETE CHARACTER 




BACKSPACE 


KEY TO DELETE LINE 




DELETE 


KEY TO END FILE 




Ctrl C 


KEY TO MOVE CURSOR DOWN 




down arrow 


KEY TO MOVE CURSOR LEFT 




left arrow 


KEY TO MOVE CURSOR RIGHT 




right arrow 


KEY TO MOVE CURSOR UP 




up arrow 
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CURRENT UCSD P- SYSTEM BUGS: 



During final checkout several bugs with p-System Software were found 
which have not yet been corrected. SAGE will make available the 
corrections to these problems as soon as solutions have been 
developed or fixes are made available from Softech Microsystems. 

1. 68000 Assembler sometimes generates bad code file. 

The 68000 assembler generates a bad code file format when the code 
exactly fills a two block area. The symptom is the output of a 'Bad 
Procedure Dictionary' message by the Linker. The problem may be 
temporarily overcome by adding an extra word of code to avoid the 
exact boundry condition. 

2. 68000 Assembler generates bad relocation information. 

In the case where a value is formed containing the difference 
between two program labels, the value should be absolute no matter 
where the code is placed. The assembler generates erroneous 
relocation information indicating that the value should be modified 
when the program is loaded by the p-System Interpreter. The value 
generated in the actual code area is correct so the BIOS or other 
non-Linked and Compressed programs will never see the problem. The 
problem is only experienced by programs which are Linked and loaded 
with p-code or are Compressed (for pure stand alone application) . 

3. 68000 Assembler problems with .ABSOLUTE directive. 

The .ABSOLUTE directive should be avoided with the 68000 version 
Assembler. All normal program counter relative addresses (program 
labels) are treated as absolute values which causes problems with 
Branch instructions and other instructions which assemble 
differently with absolute vs relative addressing. 

4. YALOE causes Stack Overflow in Extended Memory system. 

The non screen oriented editor, YALOE, causes a Stack Overflow when 
reading in a file in the normal SAGE II Extended Memory (separate 
code and data) environment. If YALOE must be used, the SETUP 
program may be used to configure a SYSTEM. MISCINFO which will boot 
up with a non Extended Memory environment. This is done by setting 
the Code Pool Address (high and low parts) to zero as well as 
setting the Has Extended Memory field to FALSE. 

5 . { $D+} compiler option causes Backend Error 30 . 

The current Pascal compiler causes an error during the second pass 
when used with the {$D+} option for symbolic debugging. 
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6, Long files cause the Editor to crash. 

Reading in a long file (>66 blocks) will crash the screen Editor. 



7. Problems with Adventure program in USUS distribution. 

The Adventure program in the USUS Library has two problems when used 
on a SAGE II system. The first seems to be a recent change to the 
operating system which does not handle the end of file condition 
properly. It causes an error "Ring Buffer Overflow" when reading in 
the data files for the Adventure initialization program. The error 
may be avoided by removing the last carriage return at the end of 
each of the textual data files. 

The second problem is actually a bug in the Adventure program which 
did not show up in pre-version IV systems. Unfortunately it causes 
various Exception errors (Address Errors, Bus Errors, and even RAM 
Parity errors) . The program defines two records (ARYS & VARYS) on 
the heap and then reads data into them with a BLOCKREAD. The amount 
of data read exceeds the size of the records thus overwriting 
something in the Heap area beyond the allocated records. In older 
versions of the p-System the Heap had a simpler allocation and 
nothing of value was ever overwritten. The solution is to allocate 
more room in the two records and revise the calculation for the 
amount of data read into the records. 

8. BOOTER transfers all of first track. 

The p-System utility routine BOOTER transfers all of the first track 
(8 blocks) instead of the first two blocks thus wiping out the 
previous directory. For the SAGE II, the SAGEUTIL program should be 
used for transfering bootstraps. 



9. Update required to final Version IV. 1 files. 

Softech has not provided a final release of the Version IV. 1 system. 
When this release is received SAGE will update your system with the 
final files. Also the Print Spooler, currently missing from the 
distribution, will be provided. 
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